VMS Help  —  DTM  User Defined Filters, Global Replace Procedure
   The supplied file SYS$LIBRARY:DTM$UFDEFINES.TPU contains a global
   replace procedure and some predefined patterns that can be used to
   build filters. The specification of procedure global_replace is
   as follows:

   PROCEDURE global_replace ( pattern_to_replace,
                              replacement_string;
                              search_mode,
                              evaluate_replacement,
                              convert_linefeeds)
   DESCRIPTION:
     Replace all occurrences of a given pattern with a
     given string in the buffer "filter_buffer".

   PARAMETERS:

     pattern_to_replace        The pattern to be replaced.

     replacement_string        The string to be substituted.

     search_mode (optional)    The mode of pattern matching
                               to be used when searching
                               for the pattern. Should be
                               one of:
                                 NO_EXACT (default)
                                 EXACT
                                 TPU$K_SEARCH_CASE
                                 TPU$K_SEARCH_DIACRITICAL

     evaluate_replacement      Specifies whether the replacement
       (optional)              string is to be evaluated.
                               Should be one of:
                                 OFF, 0 (default)
                                 ON, 1
                               If specified as ON or 1,
                               the replacement string is
                               evaluated before use. This is
                               needed if the replacement
                               string contains any partial
                               pattern variables. In this
                               case, any string literals
                               in the replacement string
                               must be specified as nested
                               strings and partial pattern
                               variables converted to
                               strings using STR.

     convert_linefeeds         Specifies whether any linefeed
       (optional)              characters in the replacement
                               string are to be converted
                               into line breaks.
                               Should be one of:
                                 OFF, 0 (default)
                                 ON, 1
Close Help